home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / tools / falc_uti / backwd28 / backward.tos / ENGLISH.DOC / BACK3ENG.TXT < prev   
Text File  |  1995-06-09  |  18KB  |  343 lines
  1.  
  2.  
  3.  
  4. BACKWARD III
  5. The ATARI ST emulator for Falcon 030
  6. by Cyrille Dupuydauby.
  7.  
  8. adresse: 53 domaine des aigles
  9. 60500 Chantilly
  10. France
  11.  
  12. e-mail: dupuyda@ibm.net
  13.  
  14. mailbox: Brasil, the ATARI BBS ou
  15. Zyllius.
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24. Release 1.00.
  25. Shareware (Keyware).
  26.  
  27. Warnings:
  28. Backward is Shareware, which means it is freely distributed (distribution will be 
  29. detailed later) so that anyone can use and judge it. If you find Backward useful and you 
  30. intend to use it on a regular basis, you must retribute its author, hence helping future 
  31. development. Backward III is the result of a (very) long work, please take this into 
  32. account.
  33. More precisely, Backward III is Keyware, which means the demo version (without 
  34. the registration key) is somewhat limited. Those limits do not prevent an intermitent 
  35. use, and whereas older version, no function is removed.
  36. You'll find more explainations on registering further in this document.
  37.  
  38. Distribution:
  39. Backward III may be distributed as long:
  40. - the distributed is the demo (keyless) version.
  41. - all files are kept unchanged (and please keep other languages files).
  42. - the price for it just covers duplication and distribution costs.
  43.  
  44. Remarks:
  45. -This document refers to standard actions such as using mouse, copying files, 
  46. formatting floppies and so on. In case of doubt, please refer to your computer 
  47. documentation.
  48. - This is the beta (pre-release) version of Backward III. It has been carefully 
  49. tested, and should be bug-free. The final release is due to July 1995, so please send 
  50. your comments or requests before the end of June.
  51.  
  52.  
  53. Introduction:
  54. Backward III (which will be now named as Backward) is an ST emulator, which 
  55. means it helps old ST software to work on your Falcon. Furthermore, Backward offers 
  56. some helpful functions, which easy the use of any software. Finally, Backward corrects 
  57. various system bugs, improving general performance.
  58. Most of Falcon users knows Backward II and a few Backward I. But please take 
  59. the time to read this document, since Backward use as evolved.
  60. Backward was created in April 1993 and is written in assembler.
  61. Backward is a kit made of various files and programs:
  62. - BACKLOAD.PRG and BCKWTSR.EXE files contain the emulator itself.
  63. - BACKWARD.APP and the BCKW???.RSC files contain the library manager.
  64. - PATCH.GTP, UNPATCH.GTP and the *.PTC files contain the patch programs 
  65. and patch scripts.
  66. - MINIDESK.PRG is the desktop program used when the GEM is deactivated.
  67. - BACKWARD.DKS contains the set-up library.
  68. - BACKWARD.INF contains the preferences.
  69. - the *.DOC directories contains this document in various languages and various 
  70. formats.
  71.  
  72. Installation:
  73. Floppy:
  74. Even if Backward has been especially designed for hard disk, it can be used on a 
  75. floppy. Just take a DD (720Kb) floppy, create an AUTO directory and put 
  76. BACKLOAD.PRG in it. Then copy BCKWTSR.EXE,  BACKWARD.* and the 
  77. BCKW???.RSC files on the root directory. You may copy the other files as you see fit. 
  78. Each time you'd like to use Backward, just start (cold start i.e power on) your computer 
  79. with this floppy in the drive. Backward will then install itself in memory. Once you're 
  80. back to the desktop, you can use any program. As long as you neither press the Reset 
  81. button neither do a cold start, Backward will be resident. So you don't have to keep the 
  82. floppy in.
  83.  
  84. Hard Drive:
  85. Two tricks:
  86. - keeping the Alternate key down while booting prevents the hard drive to start 
  87. (you have to do it twice for booting on a floppy). Using this method you can put 
  88. Backward on a floppy if you do not want to have it always resident.
  89. - keeping the Control key down while booting prevents AUTO programs and desk 
  90. accessories to be loaded. This way you can rename or delete BACKLOAD.PRG for 
  91. deactivating it (please remember that Backward is memory resident until the next cold 
  92. start).
  93. The hard disk installation is exactly the same than the floppy one. Just work on 
  94. drive C instead of Drive A. If you want to reduce boot time, install BACKLOAD.PRG 
  95. as the first program in your AUTO folder (for knowing the real file order, just use the 
  96. unsorted option). For altering this order, create on AUTA directory on drive C and 
  97. move the files from the AUTO directory to AUTA one  by one. Then delete the 
  98. AUTO directory and rename AUTA to AUTO.
  99. Anyway, BACKLOAD.PRG must be executed before MINT.PRG.
  100. Sadly, it is impossible to use concurrently Backward and a virtual memory driver 
  101. (such as Outside or VRam).
  102. First test:
  103. When BACKLOAD.PRG is executed a message is shortly displayed. Then the 
  104. screen become a bit messy and your computer restart. If everything is ok, after the 
  105. ATARI logo is displayed, a message saying that Backward is resident is displayed.
  106. If you have trouble in any of those stages, check that all files are presents.
  107. You can also press one of the Shift keys when the message is displayed, it will 
  108. allows you do disable Backward (but it will stay in memory).
  109. If you still have troubles, try booting with no desk accessories and no AUTO 
  110. programs (apart from BACKLOAD.PRG). If you have still problems, please contact 
  111. me (via internet e-mail if available).
  112.  
  113. The emulator:
  114. As the emulator is memory resident, it is rather invisible. But once it is resident, 
  115. you can alter its set up through keyboard short cuts. Those short cuts are 
  116. Control+Alternate+ a numeric keypad key:
  117. ( for 16Mhz (high speed).
  118. ) for 8Mhz (low speed).
  119. 7 for deactivating the instruction cache.
  120. 8 for activating it.
  121. 4 for deactivating the data cache.
  122. 5 for activating it.
  123. * for switching between PAL and NTSC display (50hz/60hz).
  124. + for louder sound.
  125. - for softer sound.
  126.  
  127. Delete for doing a cold start.
  128.  
  129. Those short-cuts have been changed since Backward II (they look a bit more 
  130. logical now). You cannot alter the Blitter speed (it's useless). Those short cuts should 
  131. be always available, but sometimes the keyboard is deactivated (during floppy access or 
  132. after a crash).
  133.  
  134. Note for Backward II users: As you have certainly noticed, shot cuts have been 
  135. slightly changed. The Blitter frequency cannot be changed (it is kept at 16Mhz) because 
  136. it was useless.
  137.  
  138. The library Manager:
  139. Preliminary note: The current version of the library manager is currently an 
  140. improved version of the Backward II interface. But I hope I will be able to write a new 
  141. one.
  142. Preferences:
  143. Preferences include the general options and the default set up. Please remember 
  144. the the default set up is used when you run any non recognised programs (including the 
  145. GEM desktop). So if you have a default-set up with no cache and/or a 68030 running at 
  146. 8 Mhz, you will have a slow Falcon. In order to avoid difficult situations, GEM and 
  147. hard drive are always turned on for the default set-up.
  148. You can press one the Shift keys when the Backward message is displayed at boot 
  149. time, it allows you to disable Backward: general options are all turned off, TOS patches 
  150. are off, frequency is 16Mhz, caches are on etc...
  151. Links:
  152. Backward is able to recognize programs and to adapt its setup accordingly. For 
  153. such a recognition, Backward uses keys, which are extracted from the program. There 
  154. are two kinds of links : floppy and program links.
  155. A floppy link associates a set up to a floppy disk. When you boot up on a floppy, 
  156. Backward reads the boot sector, extracts some keys and check the presence of those 
  157. keys in the library. Floppy links allow you to use any Backward options, but they are 
  158. only recognized at boot-up.
  159. A program link associates a set up to a program file (e.g.: *.PRG or *.TOS). When 
  160. you run a program (from the desktop, or in the AUTO folder while booting), Backward 
  161. III extracts keys from the file and checks for their presence in the library. Program links 
  162. do not allow all Backward III options (e.g : changing memory size or deactivating 
  163. GEM), but they allow you to use program on an hard disk.
  164. Presentation:
  165. When you start BACKWARD.APP, the screen displays a menu bar and a window 
  166. showing the library content (for the moment, you can use only one library which is 
  167. stored in BACKWARD.DKS). The demo version allows up to 20 set ups in the library 
  168. and the registered one allows up to 2000 (more on request).
  169. Only the name of a set up is displayed in the window. They are sorted in 
  170. alphabetical order.
  171. The Menu Bar:
  172. In the first menu (BACKWARD) you find the classical 'About...' entry and your 
  173. accessories.
  174. The second menu (File) gives you access to :
  175. - Save library : writes immediately the library to the disk.
  176. - Save Preferences : save the default set up and the general options. The default 
  177. set up can be modified when there isn't any selection.
  178. - Quit : go back to the Desktop.
  179.  
  180. The third menu (Library) gives access to :
  181. - Add a set-up... : for adding a new set up in the library.
  182. - Delete a set-up : for removing the currently selected set up.
  183. - Re-scan disk : read the floppy and tries to find the associated set-up. Sadly there 
  184. is no equivalent option for program links.
  185. The fourth menu (Options) :
  186. - Register.. : gives access to the registration box. You have to enter your name and 
  187. your key for registering a demo version (beware, case are significant).
  188. - Set up.. : allow you to change the selected set up (or the default set up if none is 
  189. selected).
  190. - General Options ...: gives access to the options dialogue box which contains 
  191. options shared by all set ups.
  192.  
  193. - Then you have the pre-sets which allow you to choose easily a set up.
  194.  
  195. The Library Window:
  196. The only window shows all setups present in the library sorted by name. Arrows 
  197. allow you to change the part of the library displayed. If you press a alphabetical key, the 
  198. contents of the window change to display setups starting with this letter.
  199. A single click on a setup selects it, and a double click edits the setup.
  200. When the library is modified, the window title changes to '* Library' as a reminder.
  201.  
  202. The setup dialogue:
  203. This is the essential part of Backward; in this box you define the various options of 
  204. the emulator which will be used when you run the associated program or floppy.
  205. A the top of the dialogue, there is a text field where you can enter and edit the 
  206. setup name.
  207. There is also a button : 'Link to ...'. Each set up must be linked to a floppy or a 
  208. program, otherwise it will useless. If you press this button, a alert box ask you whether 
  209. it is a floppy or a program link. If you select floppy, Backward reads the floppy in drive 
  210. A and associates the setup to this disk. If you select program, the file selector is 
  211. displayed and you can select a program to which will be linked the setup.
  212.  
  213. Then you have various options which are grouped by category:
  214. · MC 68030 : options related to the processor :
  215. - Frequency : allows you to select the processor speed.
  216. - Caches : allows you to select which on board caches are active. None means no 
  217. cache, Inst. means instruction cache only, Data means data cache only and both means 
  218. both caches. Most programs works very well with data cache active, but some do not 
  219. cope with instruction cache.
  220.  
  221. With a VGA display, a Falcon at 8Mhz with no cache is slower that a ST() 
  222. (approx. 10% slower). But with a VGA monitor, 8Mhz and data cache, the Falcon is 
  223. approximately as fast as an ST.
  224.  
  225. ·Hardware : options related to the hardware :
  226. - Speaker : allows you to switch on/off the internal speaker.
  227. - Hard Disk : allows to to ignore the hard drive. This option works only with floppy 
  228. links. If you keep the hard drive, the falcon always uses the AUTO folder and desk 
  229. accessories present on drive C.
  230. - Video (STlow, STMed, STHigh, Def.): allows you to change the resolution (Def. 
  231. means that the resolution is not changed). When the program terminates, the previous 
  232. screen resolution is restored.
  233.  
  234. ·System : miscellaneous options:
  235. - Sound errors (None/Corr./Spec./STE) : decides how bus errors are handled. 
  236. None means that nothing is done, when an error occurs, two bombs are displayed. 
  237. Corr. means that each access causing an error is correctly re-executed, this option slows 
  238. down your computer when they are many errors (e.g: digisound). Spec. means that 
  239. Backward tries to correct the program which causes such errors; it is the more powerful 
  240. option, it works great (good sound) without slow down. STE means that such errors are 
  241. simply discarded; as it implies that sound is of lesser quality, use this option when the 
  242. others are inefficient.
  243. - Memory : allows to select the memory size. This option works only for floppy 
  244. links. Only very old programs requires a specific amount of memory (mainly 512Kb).
  245. - TOS Patches : corrects the some system calls. I have heard that previous 
  246. Backward versions had some problems with some games written in basic when this 
  247. option was on. Sincerely, this option should ALWAYS be turned on, as the Falcon 
  248. TOS is a complete mess.
  249. - GEM : allows you to deactivate GEM (works only with floppy links). It frees 
  250. 32Kb in the lower part of the memory. Some old games requires this (it allows you to 
  251. run games which works only on TOS 1.00, such as Bionic Commando or Star Trek).
  252.  
  253. Sadly, there is no perfect method for finding which setup is required for a 
  254. program. There is two main methods : either you start with a minimal setup (preset 
  255. 'Falcon') and you change some options till the program runs, or you start with the 
  256. strongest setup (preset 'ST(e)') and you remove options. The first method gives best 
  257. performance results, but the second one needs less tries. Only one rule applies : if your 
  258. program do not work with the preset 'ST(e)', it is very unlikely it can be used with this 
  259. version of Backward.
  260.  
  261. Important note : even is the dialogue allows you to turn off GEM and hard disk in 
  262. the default setup, they are always kept on to avoid troubles.
  263.  
  264. General options :
  265. There are three options : 
  266. - Multiscan screen. It concerns VGA, SVGA or Multiscan screen owners. When it 
  267. is turned on, Backward emulates PAL (i.e. 50Hz refresh rate). If your screen do not 
  268. support 50Hz Vertical Frequency (i.e. rolling screen), turn this option off.
  269. - Skip IDE drive. This option prevents the TOS for checking IDE drives. Choose it 
  270. only if you have no IDE drive (otherwise it will be hidden).
  271. - no ATARI Logo. This option disables the display of the ATARI Logo at boot 
  272. time.
  273.  
  274. MiniDesk:
  275. When GEM is deactivated, as the GEM desktop cannot be used, MiniDesk is 
  276. provided instead. As its main goal is a low memory usage, the interface is rather 
  277. simplified. It displays all directories (in brackets such as [AUTO]) and programs. The 
  278. arrows allow you to change the current selection. Pressing Enter on a directory opens it 
  279. (the directory [..] allows you to return to the previous one), and pressing enter on a 
  280. program runs it.
  281. Alphabetical keys change the current drive accordingly. GEM program won't work 
  282. when run from MiniDesk.
  283.  
  284. The Patch kit:
  285. This kit contains two programs : PATCH.GP and UNPATCH.GTP. Patch executes 
  286. a patch script to modify a program and unpatch removes those modifications. Patch 
  287. files use the extension .PTC; they are ASCII files containing patching orders.
  288. The PATCHES.LST file contains the list and short description of patch files. If you 
  289. want to apply a patch, just drag the corresponding file (e.g. KILCLOUD.PTC) on the 
  290. PATCH.GTP icon (take the time to make a backup copy of your program). Then 
  291. follow the instruction on the screen. If you want to remove the patch, drag the same 
  292. script file on UNPATCH.GTP.
  293. Remarks:
  294. - *.PTC files (generally) work only with a given version of a program.
  295. - a patched program is very unlikely to be working on a ST or without Backward, 
  296. but UNPATCH can restore it.
  297. - those patches take a lot of time and are not guaranteed (still some troubles with 
  298. Microprose Golf).
  299. - they are some securities : PATCH won't do patches if it does not recognize a 
  300. program, but if the patch failed, run unpatch to make sure that all patches are 
  301. removed.
  302. - programs listed in PATCHES.LST REQUIRES to be patched in order to run on 
  303. a Falcon.
  304.  
  305. Registration:
  306. To be registered please send 100FF (or equivalent in your currency) to the 
  307. following address :
  308. Mr Cyrille Dupuydauby
  309. 53 domaine des aigles
  310. 60500 CHANTILLY
  311. FRANCE
  312. You will receive a disk with the latest released version and a registration key and 
  313. support (e.g. you can send me copies of non-working programs).
  314.  
  315. Beyond the horizon:
  316. Some tricks:
  317. Upgrading from Backward II :
  318. The program CONVERT.PRG converts a Backward II library 
  319. (BACKWARD.DAT) in a Backward III library (BACKWARD.DKS). Simply copy it 
  320. where you have your old library and run it, the Backward III files will be automatically 
  321. created.
  322. Soft Roms:
  323. Backward offers a unique ability : using any TOS 4.xx on any Falcon. Simply get a 
  324. copy of TOS 4.xx roms in a file, name it ROM.IMG and copy it on your C drive (or 
  325. Backward floppy if you use floppies). Beware, Backward III uses ROM copies; 
  326. TOS.IMG files are RAM version of TOSs.
  327. Replacing MiniDesk:
  328. This feature will be fully integrated in the future, but you can already replace 
  329. MiniDesk by the shell (non-GEM) program you want. Simply copy your shell (e.g: 
  330. COMMAND.PRG) where MiniDesk is stored, and rename it to MINIDESK.PRG.
  331.  
  332. The future:
  333. As my free time is dramatically shrinking, I cannot make any plan beyond next 
  334. Backward version. Since the last two years, 75% of the time passed on my Falcon was 
  335. devoted to Backward.
  336. At least, I hope to find the time to rewrite the library manager, which currently 
  337. prevents Backward III to be used at its full power.
  338.  
  339. This version is dedicated to all my registered users.
  340.  
  341. See you soon !
  342.  
  343.